.. _cmlPmGnSetServoOn:

cmlPmGnSetServoOn
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmlPmGnSetServoOn ([in] VT_I4 BoardID, [in] VT_I4 NodeId, [in] VT_I4 Channel, [in] VT_I4 IsOn )                    

DESCRIPTION
`````````````  

- cmlPmGnSetServoOn() 함수는 지정한 축의 SERVO-ON 신호 출력을 제어합니다. 서보 드라이버를 
  사용하실 때는 외부에서 스위치를 이용하여 서보 드라이버의 ON/OFF를 제어할 수 있도록 하는데, 이를 
  SERVO-ON 신호라 합니다. 이 함수는 SERVO-ON 신호의 ON/OFF를 제어하는 함수입니다. 

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cml 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardID : 사용자가 설정한 디바이스(보드) ID. 
 
▶ NodeId : 사용자가 제어하고자 하는 노드 번호. 
 
▶ Channel : 축 번호. 통합 축으로 관리되는 축 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상, 최대 
통합 축 개수 - 1 이하의 값을 축 번호로 설정할 수 있습니다. 
 
▶ IsOn : SERVO-ON 신호의 출력 상태를 설정 혹은 반환 합니다. 

.. csv-table::
    :widths: 10 90
    :header-rows: 1
    :stub-columns: 0

    Value, Meaning
    0(cmlFALSE), SERVO-OFF
    1(cmlTRUE), SERVO-ON

RETURN VALUE
`````````````
.. csv-table::
    :widths: 10 90
    :header-rows: 1
    :stub-columns: 0

    Value, Meaning
    음수, 수행 실패
    0(ERR_NONE), 수행 성공

REFERENCE
```````````````

- 서보드라이버 Servo-ON 신호의 출력 로직은 cmlPmCfgSetMioProperty(Axis#, ccmlMPID_SVON_LOGIC, 
  cmlLOGIC_A) 또는 cmlPmCfgSetMioProperty(Axis#, ccmlMPID_SVON_LOGIC, ccmlLOGIC_B) 명령을 
  통해 설정할 수 있습니다. 

EXAMPLE
```````````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

    C/C++ 
    #include “ComiMLink2_SDK.h” 
    #include “ComiMLink3_SDK_Def.h” 
    long nChannel = 0; 
    long nServoState = 0; 
    //0번 축을 선택합니다. 
    /* SERVO ON/OFF 상태를 얻어와 SERVO-OFF 상태면 SERVO-ON 출력 신호를 ON시킵니다. */ 
    cmlPmGnGetServoOn(BoardID, 0, nChannel, &nServoState ); 
    if( nServoState != cmlFALSE ) 
    { 
    cmlPmGnSetServoOn(BoardID, nAxis, cmlTRUE );  
    }